home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 034a / doors13.zip / MANUAL.DEU < prev    next >
Text File  |  1991-04-10  |  53KB  |  1,657 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                                        DOORSWAP
  11.                                          1.30
  12.                                    März/April 1991
  13.  
  14.  
  15.                                          von
  16.  
  17.                                      Volker König
  18.                                  Mettmanner Straße 71
  19.                                   4000 Düsseldorf 1
  20.  
  21.  
  22.                                   FIDO: 2:241/4031.3
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.                                                   DOORSWAP.DOC Version 1.30
  77.                                                                  10.04.1991
  78.           
  79.           
  80.           
  81.           
  82.                                         INHALT
  83.                                         ------
  84.  
  85.  
  86.  
  87.                          1.   Noch'n Utility                3
  88.                          1.1  Das Shareware-Konzept.        4
  89.                          1.2  Lizenzabkommen                5
  90.                          1.3  Gewährleistung                7
  91.  
  92.                          2    Systemvoraussetzungen         8
  93.                          2.1  Hardwarevoraussetzungen       8
  94.                          2.2  Softwarevoraussetzungen       9
  95.  
  96.                          3    Installation                 11
  97.                          3.1  Das Swapfile                 13
  98.                          3.2  Ramdisk                      13
  99.                          3.3  Verschachteltes Swapping     14
  100.  
  101.                          4    Optionen                     15
  102.  
  103.                          5    Zukunftsvisonen              17
  104.  
  105.                          6    Fehlermeldungen              18
  106.  
  107.                          7    Index                        20
  108.  
  109.                          8    Geschichtliches              22
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.           
  139.           
  140.                                                                     Seite 2
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.                                                   DOORSWAP.DOC Version 1.30
  149.                                                                  10.04.1991
  150.           
  151.           
  152.  
  153.           1.  Noch'n Utility
  154.               --------------
  155.  
  156.           Was soll DOORSWAP?
  157.  
  158.           Viele Mailboxprogramme bieten die Möglichkeit, aus dem Programm
  159.           heraus Statistiksoftware, Datenbanken oder auch - nein, vielmehr:
  160.           in erster Linie - Onlinespiele zu starten. Aber: Diese Option
  161.           wurde bei vielen Programmen nur sehr halbherzig realisiert. Es
  162.           liegt die Vermutung nahe, daß in vielen Fällen die Option "DOOR"
  163.           bzw. "SPIEL" oder "EXTERN" nur aus optischen Gründen installiert
  164.           wurde.
  165.  
  166.           Es setzt sich naemlich immer mehr durch, externe Programme - wie
  167.           etwa DSZ - anstelle eigener Problemlösungen einzusetzen, was
  168.           sicherlich Vorteile hat. Schließlich werden dadurch Übertragungs-
  169.           protokolle standardisiert und die Box kann ohne Programmänderung
  170.           - durch einfache Anmeldung neuer Tochterprozesse - mit bislang
  171.           noch unbekannten Transferprotokollen und Komprimierungsverfahren
  172.           arbeiten.
  173.  
  174.           Um diese Hilfsprogramme einsetzen zu können, müssen die
  175.           Programmierer zwangsläufig eine Möglichkeit offenhalten, ähnlich
  176.           der SYSTEM-Funktion in C oder SHELL in BASIC, DOS-Tochterprozesse
  177.           zu starten. Offensichtlich ist nun in vielen Fällen die "DOOR"-
  178.           oder "SPIEL"-Funktion ein Abfallprodukt hiervon. Meist scheitern
  179.           aufwendigere Spiele am mangelnden Speicherplatz, der ihnen zur
  180.           Verfügung gestellt wird.
  181.  
  182.           Eben dies Problem ergab sich mit Forem PC 2.3 und Tradewars ][.
  183.           Beide arbeiteten tadellos zusammen - bis auf die unbedeutenden
  184.           Abstürze bei jedem dritten oder vierten Lauf von TW.
  185.  
  186.           "Das muß man doch irgendwie lösen können!"
  187.  
  188.           Eben.
  189.  
  190.           Nach reichlich schlaflosen Nächten und versauten Wochenenden,
  191.           dem Wälzen von Fachzeitungen und etlichen Besuchen in der
  192.           Düsseldorfer Zentralbücherei mit ihrer umfangreichen Sammlung an
  193.           Vorjahresausgaben von Zeitschriften (besonders der c't) entstand
  194.           dann schließlich das vorliegende Programm.
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.           
  211.           
  212.                                                                     Seite 3
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.                                                   DOORSWAP.DOC Version 1.30
  221.                                                                  10.04.1991
  222.           
  223.           
  224.           1.1 Das Shareware-Konzept.
  225.               ----------------------
  226.  
  227.           Ich glaube, ich brauche nicht viel zu diesem Konzept zu sagen.
  228.  
  229.           Anders, als bei Public-Domain ist bei Shareware nur das Kopieren
  230.           und Weitergeben gestattet. Die Nutzung ist nur solange erlaubt,
  231.           wie sie nicht zur Gewohnheit wird. Damit sie nicht zur Gewohnheit
  232.           wird verweigert DOOR.EXE an jedem Tag, dessen Zahl durch 5
  233.           teilbar ist, den Dienst. Also beispielsweise im Januar am 5.1.,
  234.           am 10.1., am 15.1., am 20.1. und so weiter. Die registrierte
  235.           Version hat diese Einschränkung natürlich nicht.
  236.  
  237.           Bieten Sie das Programm in Ihrer Mailbox oder über Ihre
  238.           Shareware-Sammlung an - nur, wenn Sie mehr tun, als es auf einer
  239.           Versuchsbasis zu (be)nutzen, sind Sie mir einen kleinen Obulus
  240.           schuldig.
  241.  
  242.           Ich erlaube hiermit widerruflich die Vervielfältigung und
  243.           Weitergabe des Programmpaketes DOORSWAP als sog. Shareware,
  244.           solange
  245.  
  246.           - keine Datei hinzugefügt, entfernt oder verändert wird,
  247.           - das Paket nur als ganzes - ohne weitere urheberrechtliche
  248.             Vermerke - in Form der Datei DOORS13.EXE weitergegeben wird,
  249.           - das Programm nicht in Verbindung mit oder als Zusatz zu einem
  250.             andern Produkt abgegeben wird (dies schließt nicht die
  251.             Weitergabe in einer Sammlung von Hilfsprogrammen ein, für die
  252.             keine natürliche oder juristische Person das Urheberrecht
  253.             geltend macht) und
  254.           - die geforderte Vergütung für die Weitergabe von DOORSWAP oder
  255.             der Programmsammlung, die DOORSWAP beeinhaltet, DM 5,-- nicht
  256.             übersteigt.
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.           
  283.           
  284.                                                                     Seite 4
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.                                                   DOORSWAP.DOC Version 1.30
  293.                                                                  10.04.1991
  294.           
  295.           
  296.           1.2  Lizenzabkommen
  297.                --------------
  298.  
  299.           Nach den Bestimmungen des deutschen Urheberrechts ist jegliche
  300.           Nutzung eines urheberrechtlich geschützten Werkes ohne
  301.           ausdrückliche Erlaubnis des Urhebers verboten und kann zu Geld-
  302.           und Haftstrafen sowie zu Schadensersatzforderungen führen.
  303.  
  304.           Gegen ein Entgelt von DM 20,--, per Euroscheck ("nur zur
  305.           Verrechnung"), in Bar (bitte!!! nicht in Briefmarken) oder per
  306.           Banküberweisung schicke ich Ihnen ein Exemplar von Doorswap 1.30
  307.           oder, sofern erhältlich, einer Nachfolgeversion mit Ihrer
  308.           persönlichen Registrier-Nummer und selbstverständlich ohne den
  309.           lästigen Vermerk mit der unregistrierten Version. Dies Angebot
  310.           gilt übrigens nur für Bestellungen aus Deutschland. Wegen der
  311.           höheren Portokosten schauen Sie bitte für Registrierungen aus dem
  312.           Ausland in das File MANUAL.ENG. 
  313.  
  314.           Die registrierte Version ist allerdings nicht mehr zum Kopieren
  315.           freigegeben. Sofern Sie mehrere Mailboxen betreiben - setzen Sie
  316.           sich mit mir in Verbindung. Über eine Sammellizenz lasse ich mit
  317.           mir reden; diese wird sicherlich günstiger als mehrere
  318.           Einzellizenzen sein. 
  319.  
  320.           Wenn Sie bereits im Besitz einer registrierten Version von
  321.           DOORSWAP sind, die eine Versionsnummer kleiner 1.30 hat, können
  322.           Sie gegen DM 12,50 ein Update bekommen.
  323.  
  324.           Über Änderungen/Anpassungen auf Ihren Rechner oder Ihre Software
  325.           lasse ich gerne mit mir reden; ich bin ja auch an Weiterent-
  326.           wicklungen und Verbesserungen interessiert.
  327.  
  328.           Bitte setzen Sie sich zur Registrierung mit mir unter folgender
  329.           Anschrift in Verbindung:
  330.  
  331.           Volker König
  332.           Mettmanner Straße 71
  333.           4000 Düsseldorf 1
  334.  
  335.           Bei Zahlung per Überweisung teile ich Ihnen meine Bankverbindung
  336.           auf Anfrage mit. Beachten Sie jedoch, daß ich die lizensierte
  337.           Version in diesem Fall erst dann abschicken werde, wenn die
  338.           Überweisung auf meinem Bankkonto angekommen ist. Gebrannte Kinder
  339.           scheuen das Feuer.
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.           
  355.           
  356.                                                                     Seite 5
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.                                                   DOORSWAP.DOC Version 1.30
  365.                                                                  10.04.1991
  366.           
  367.           
  368.           Bitte beantworten Sie mir bei Gelegenheit der Registrierung
  369.           folgende Fragen:
  370.  
  371.           In welcher Mailbox
  372.           wird DOORSWAP benutzt?   ________________________________________
  373.           Telefonnummer            _________________ Netz? ________________
  374.           Mailboxsoftware          ________________________________________
  375.           Online-Spiel(e)          ________________________________________
  376.           _________________________________________________________________
  377.           DOS-Version              ________________________________________
  378.           zusätzliche Programme    ________________________________________
  379.  
  380.           Hardware
  381.  
  382.                 o PC/XT                     Speicherausbau __________ kByte
  383.                 o PC/AT (80286)             davon für DOS  __________ kByte
  384.                 o PC/AT (80384/80486)       für RAM-Disk   __________ kByte
  385.                 o PS/2 Modell ______        __ Festplatte(n) mit insgesamt
  386.                                             _________ MByte Speicher
  387.  
  388.  
  389.           Selbstverständlich unterliegen diese Daten dem Datenschutz. Ich
  390.           werde sie niemandem weitergeben oder offenbaren, außer, wenn es
  391.           sich um Hilfen Problemlösungen handelt, für die das Wissen um
  392.           bestimmte Daten notwendig ist. Diese Daten sollen in erster Linie
  393.           dabei helfen, Probleme zu beseitigen und anhand der Ausrüstung
  394.           der Anwender mit Hard- und Software Verbesserungsmöglichkeiten
  395.           herauszufinden.
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.           
  427.           
  428.                                                                     Seite 6
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.                                                   DOORSWAP.DOC Version 1.30
  437.                                                                  10.04.1991
  438.           
  439.           
  440.           1.3  Gewährleistung
  441.                --------------
  442.  
  443.           Sie können sicherlich verstehen, daß ich mich bei einem Preis von
  444.           20,-- DM für jedes Programm und der immensen (hüstel...) Zahl von
  445.           Mailboxen, die es nutzen können, von irgendwelchen Schadenersatz-
  446.           forderungen freihalten möchte.
  447.  
  448.           Sachmängel
  449.           Die sechsmonatige Gewährleistung für Sachmängel aus dem
  450.           Bürgerlichen Gestzbuch darf ich leider nicht umgehen, jedoch gehe
  451.           ich davon aus, daß Sie das Programm vor der Registrierung
  452.           eingehend getestet haben und wissen, wo die Fehler liegen und was
  453.           es kann. Außerdem garantiere ich die Funktion nur auf einem
  454.           Rechner, der identisch mit dem meinen ist:
  455.  
  456.           AT 286, Hersteller: MANDAX (Taiwan), mit AMI-BIOS, Festplatte
  457.           Seagate ST225, Herkuleskarte, MS-DOS 3.2.
  458.  
  459.           in Verbindung mit FOREM-PC und Tradewars ][
  460.  
  461.           Sollten durch irgendwelche Programmfehler Datenverluste oder
  462.           Sachschäden auftreten, so sehe ich mich nur dann als dafür
  463.           verantwortlich an, wenn Ihr Rechner von der Konfiguration her mit
  464.           meinem übereinstimmt.
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.           
  499.           
  500.                                                                     Seite 7
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.                                                   DOORSWAP.DOC Version 1.30
  509.                                                                  10.04.1991
  510.           
  511.           
  512.           2    Systemvoraussetzungen
  513.                ---------------------
  514.  
  515.           DOORSWAP sollte auf jedem Rechner arbeiten, der eine Festplatte
  516.           besitzt, den Interruptvektor 62h nicht für irgendwelche anderen
  517.           Spiele benutzt und mit DOS 3.0 oder später betrieben wird. Ich
  518.           musste leider auf den einen oder andern Bug von DOS 3.2 Rücksicht
  519.           nehmen, was allerdings bis DOS 4.01 keine Probleme bereitete. Wer
  520.           weiß, was spätere Versionen bringen!
  521.  
  522.           Nicht funktioniert hat das Programm in Verbindung mit GALACTIC
  523.           WARZONE und FOREM PC 2.3 auf einem Commodore PC 10. Da WARZONE
  524.           jedoch auch ohne FOREM und DOORSWAP nicht funktionierte und immer
  525.           auf nicht vorhandene COM-Ports zugriff, ist anzunehmen, daß der
  526.           Fehler im Commodore-BIOS oder in der Einstellung der RS232 an
  527.           diesem spezifischen Rechner zurückzuführen ist.
  528.  
  529.           Sehr instabil lief DOORSWAP übrigens bei einem Bekannten unter
  530.           DeskView, möglicherweise haben DOORSWAP und DeskView sich öfters
  531.           gegenseitig in's Abseits gestellt.
  532.  
  533.           2.1  Hardwarevoraussetzungen
  534.                -----------------------
  535.  
  536.           Es sollte eine Festplatte "C" existieren, die noch 700 kBytes an
  537.           Platz bietet.
  538.  
  539.           Von Vorteil (aber keine Voraussetzung) ist eine zum UART 8250
  540.           kompatible RS-232-Schnittstelle, auch "serielles Port" oder "COM-
  541.           Port" genannt. Wie Sie beim ersten Aufruf bemerken werden,
  542.           ermittelt das Aktivatorprogramm DOOR.EXE die vermutlich von der
  543.           Mailbox belegte Schnittstelle und gibt eine Copyrightmeldung
  544.           darauf aus.
  545.  
  546.           Der Aufruf von DOORSWAP ruft immer kleinere Verzögerungen hervor
  547.           und nicht in jedem System hat man die Möglichkeit, Textfiles mit
  548.           der Erklärung "Bitte warten, DOORSWAP arbeitet..." vor dem Aufruf
  549.           des Spiels über das COM-Port auszugeben. Ein kleiner Hinweis auf
  550.           das arbeitende Programm und etwas Eigenwerbung schaden sicher in
  551.           dieser Hinsicht niemandem.
  552.  
  553.           Um die belegte Schnittstelle zu finden sucht DOORSWAP die dem DOS
  554.           bekannten Schnittstellen ab (bis zu vier Stück) und nimmt an, daß
  555.           die erste dieser Schnittstellen, an der das Signal "Carrier
  556.           Detect" gesetzt ist, mit einem Modem verbunden ist. Wird keine
  557.           aktive Schnittstelle gefunden, so wird auch keine Meldung
  558.           ausgegeben. Mit den im weiteren Verlauf dieser Dokumentation
  559.           erwähnten Optionen werden Sie jedoch auch bei bestehender
  560.           Verbindung die Ausgabe unterdrücken können.
  561.  
  562.           Die Meldungen werden übrigens nun unter Umgehung des
  563.           Betriebssystems direkt dahin ausgegeben, wo DOOR.EXE einen UART
  564.           8250 vermutet. Diese Angaben sollte ausreichen, um gewieften
  565.           DEBUGgern ein Abstellen der Meldungen zu ermöglichen. Jedoch
  566.           können Sie auch hier mit einer Option die Ausgabe durch einen
  567.           eventuell vorhandenen FOSSIL-Treiber vornehmen.
  568.  
  569.           Speicherplatz ist nicht viel notwendig, der soll ja gerade
  570.           
  571.           
  572.                                                                     Seite 8
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.                                                   DOORSWAP.DOC Version 1.30
  581.                                                                  10.04.1991
  582.           
  583.           
  584.           "vermehrt" werden. Lediglich zehn Kilobytes müssen mehr
  585.           zur Verfügung stehen, als das Mailboxprogramm zum Betrieb
  586.           benötigt. Ebenso muß ein Programm von etwas mehr als der Länge
  587.           von DOOR.EXE noch als Externa aufgerufen werden können.
  588.  
  589.  
  590.           2.2  Softwarevoraussetzungen
  591.                -----------------------
  592.  
  593.           Im Bereich der Systemsoftware müssen Sie beachten, daß Sie MS-DOS
  594.           3.00 oder später benutzen. MS-DOS 3.2 wird empfohlen, sofern Sie
  595.           mit anderen Versionen Probleme bekommen sollten.
  596.  
  597.           Jedoch habe ich das Programm bereits auf verschiedenen Rechnern
  598.           und unter MS-DOS 3.00 bis 4.01 getestet. Da wohl die benutzen
  599.           Routinen bis hin zu DOS 4.01 nicht geändert wurden, sollte es bis
  600.           auf Weiteres keine Kompatibilitätsschwierigkeiten geben.
  601.  
  602.           RAM-Disks und Cache-Speicher dürfen nur im Extended oder Expanded
  603.           Memory liegen.
  604.  
  605.           Sie dürfen grundsätzlich alle Gerätetreiber (etwa ANSI.SYS)
  606.           weiterhin installieren. Allerdings ist es äußerst ungünstig, wenn
  607.           irgendwelche Teile dieser Software ebenso wie DOORSWAP am DOS-
  608.           internen Speicheraufbau manipulieren oder gar im laufenden
  609.           Betrieb Interruptvektoren verändern. Außerdem müssen Sie darauf
  610.           achten, daß DOORSWAP als definitiv letztes Programm installiert
  611.           wird. Alle nach DOORSWAP installierten TSR-Programme stehen den
  612.           externen Programmen nicht mehr zur Verfügung.
  613.  
  614.           Probleme können allerdings mit der Testversion von DOORSWAP
  615.           ermittelt werden: Funktioniert sie fehlerfrei, so liegt zumindest
  616.           keine funktionsstörende Beeinträchtigung vor.
  617.  
  618.           Tastaturtreiber und ähnliche nützliche Dinge, ebenso wie
  619.           SIDEKICK-Clones, funktionieren unter DOORSWAP zumeist auch
  620.           fehlerfrei.
  621.  
  622.           Die externen Spiele oder Hilfsprogramme, die über DOORSWAP
  623.           aufgerufen werden, dürfen ebenso wie das Mailboxprogramm
  624.           keinerlei unkoscheren Dinge mit dem DOS treiben. Sie sollten
  625.           keine Programme resident installieren, denn diese werden nach dem
  626.           Programmende zwangsläufig und ohne Rückfrage durch Überschreiben
  627.           mit den alten Speicherinhalten gelöscht.
  628.  
  629.           Es sind vereinzelt Probleme denkbar (wenn auch noch nicht
  630.           aufgetreten), wenn das Mailboxprogramm mit FOSSIL-Treibern (X00,
  631.           BNU oder ähnliche) arbeitet. Normalerweise werden sämtliche
  632.           Interruptadressen in einem bestimmten Bereich von DOS selbst
  633.           verwaltet. FOSSIL-Treiber haben aber für den Ticker-Interrupt und
  634.           den INT 14H eigene Verwaltungsroutinen. Dazu später mehr.
  635.  
  636.           Jedoch können die FOSSIL-Treiber auch benutzt werden, um die
  637.           Meldungen über die Schnittstelle auszugeben.
  638.  
  639.           Wenn Sie eine RAM-Disk installieren, die außerhalb des DOS-
  640.           Speichers liegt (im Extended oder Expanded Memory), so können Sie
  641.           diese natürlich weiterhin benutzen. Eine RAM-Disk im DOS-Speicher
  642.           
  643.           
  644.                                                                     Seite 9
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.                                                   DOORSWAP.DOC Version 1.30
  653.                                                                  10.04.1991
  654.           
  655.           
  656.           kann nicht benutzt werden. Gleiches gilt für Cache-Programme, die
  657.           DOS-Speicher nutzen.
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.           
  715.           
  716.                                                                    Seite 10
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.                                                   DOORSWAP.DOC Version 1.30
  725.                                                                  10.04.1991
  726.           
  727.           
  728.           3    Installation
  729.                ------------
  730.  
  731.           Zur Installation ist nun im Generellen nicht mehr viel zu sagen.
  732.           DOORSWAP besteht - wie Sie sicherlich schon gemerkt haben - aus
  733.           zwei Programmen. DOORSWAP.COM ist der residente Teil. Wenn er
  734.           installiert wird, merkt er sich den Zustand aller Interruptvek-
  735.           toren und verbiegt einen davon auf eine Einsprungstelle inner-
  736.           halb des residenten Teils.
  737.  
  738.           DOOR.EXE ist das Aktivatorprogramm. Als Parameter wird ihm die
  739.           bisherige Kommandozeile zum Aufruf des externen Programmes
  740.           mitgegeben. DOOR.EXE ermittelt das belegte COM-Port und den
  741.           Inhalt der Environment-Variablen COMSPEC, DSOPT und DSFILE.
  742.           Daraufhin wird DOORSWAP über den Interrupt aktiviert, wobei
  743.           verschiedene Daten übergeben werden.
  744.  
  745.           Diese Daten sind
  746.  
  747.           - Name und Pfad des Kommandointerpreters (normalerweise
  748.             C:\COMMAND.COM)
  749.           - Parameter des zum Aufruf des Interpreters
  750.           - Name und Pfad des mit DSFILE definierten Swapfiles (soweit
  751.             definiert)
  752.  
  753.           Ich gehe davon aus, daß die meisten Mailboxprogramme in einer
  754.           endlos laufenden BATCH-Datei arbeiten, die immer wieder aus der
  755.           DOS heraus das Mailboxprogramm neu startet. Diese Datei wird in
  756.           der Regel ihrerseits von der Datei AUTOEXEC.BAT aufgerufen.
  757.  
  758.           Daher schlage ich als normale Installation des residenten Teils
  759.           vor, daß Sie DOORSWAP.COM als letzten Befehl vor Aufruf der
  760.           Mailbox in AUTOEXEC.BAT aufnehmen. Die korrekte Installation wird
  761.           durch eine kurze Meldung bestätigt. Es gehen durch DOORSWAP.COM 6
  762.           kByte Speicher verloren. DOORSWAP muß in diesem Fall als letztes
  763.           Programm vor dem Aufruf des eigentlichen Mailbox-Batchprogrammes
  764.           aufgerufen werden.
  765.  
  766.           Wenn das Mailboxprogramm innerhalb einer Schleife im File
  767.           AUTOEXEC.BAT arbeitet, so muß DOORSWAP als letztes Programm vor
  768.           dem Einstieg in die Schleife aufgerufen werden.
  769.  
  770.           VORSICHT: Mehrfachinstallationen sind in Version 1.30 noch
  771.           möglich; bei jeder Installation gehen 6 kBytes verloren !
  772.  
  773.           Innerhalb des Mailboxprogrammes ist es sehr unterschiedlich, wie
  774.           das aufrufende und aktvierende Programm DOOR.EXE am günstigsten
  775.           einzubinden ist.
  776.  
  777.           In den meisten Fällen werden externe Programme durch eine Shell-
  778.           Funktion gestartet. Sie müssen dem Mailboxprogramm im
  779.           Installationsfile oder an anderer Stelle lediglich mitteilen, wie
  780.           Sie das externe Programm vom DOS aus aufrufen würden. Nehmen wir
  781.           einmal an, das externe Programm hieße SPIEL.EXE und verlangt als
  782.           Parameter die Bezeichnung des COM-Ports bzw. das Wort LOCAL. Die
  783.           weiteren Daten (Usernamen, Level etc) holt es sich aus einem
  784.           File, das das Mailboxprogramm anlegt.
  785.  
  786.           
  787.           
  788.                                                                    Seite 11
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.                                                   DOORSWAP.DOC Version 1.30
  797.                                                                  10.04.1991
  798.           
  799.           
  800.           Von DOS aus würde dieses Spiel so aufgerufen:
  801.  
  802.           SPIEL COM1
  803.  
  804.           Exakt diese Kommandozeile müßten Sie dem Mailboxprogramm
  805.           mitteilen, damit es das Spiel aufrufen kann. Wenn das Spiel nun
  806.           über DOORSWAP aufgerufen werden soll, dann muß anstelle des
  807.           Spieles DOOR.EXE aufgerufen werden. Damit DOOR.EXE weiß, was als
  808.           externes Programm aufgerufen werden soll, müssen Sie die
  809.           bisherige Kommandozeile an DOOR als Parameter übergeben. Der
  810.           Aufruf sähe demnach wie folgt aus:
  811.  
  812.           DOOR SPIEL COM1
  813.               /^^^^^^^^^^
  814.              (bisherige Kommandozeile)
  815.  
  816.           Diese einfache Änderung des Aufrufs ist beispielsweise bei FOREM
  817.           PC möglich, ebenso bei SearchlightBBS und anderen Programmen.
  818.           Nicht verändern müssen Sie die weiteren Installationsdaten:
  819.           Level, Pfade, Laufwerke und - last but not least - den Namen des
  820.           Programms im Menü der Mailbox.
  821.  
  822.           In manchen Fällen wird jedoch das erste Wort der Kommandozeile
  823.           von der Mailbox als Befehl zum Aufruf des Spiels oder als
  824.           Anzeige im Menü angenommen. Im eben beschriebenen Fall würde das
  825.           Spiel an sich vom User der Mailbox mit dem Befehl SPIEL
  826.           aufgerufen, weil SPIEL auch das erste Wort der Kommandozeile ist.
  827.           Wenn Sie der Kommandozeile DOOR voransetzen, so müßten Sie
  828.           folgerichtig das Spiel mit dem Befehl DOOR starten. Wenn sie ein
  829.           solches System betreiben, so können Sie entweder nur ein Spiel
  830.           installieren (das dann über den Befehl DOOR aufgerufen wird) oder
  831.           sie müssen für jedes Spiel eine BATCH-Datei anlegen, die als
  832.           Namen den gewünschten Namen des Spiels als Mailboxkommando trägt.
  833.           Diese Batch-Datei beeinhaltet im genannten Fall wenigstens die
  834.           folgende Zeile:
  835.  
  836.           DOOR SPIEL COM1
  837.  
  838.           Es ist jedoch auch denkbar, in dieser Datei zunächst ein anderes
  839.           Directory anzuwählen, mit CLS den Bildschirm zu löschen oder ein
  840.           Textfile auf dem COM-Port auszugeben.
  841.  
  842.           ACHTUNG:
  843.           --------
  844.  
  845.           Nach der Installation von DOORSWAP muß WENIGSTENS ein Programm
  846.           nachgeladen worden sein, damit das Auslagern planmäßig
  847.           funktioniert. Wenn Sie DOORSWAP installiert haben und aus
  848.           derselben Kommando-Shell DOOR aufrufen, so ist dies zum Einen
  849.           Quatsch (weil nur der beim Aufruf von DOOR belegte Speicher
  850.           freigegeben wird, der bei normalem Aufruf sowieso noch frei wäre)
  851.           und wird zum andern unweigerlich zum Absturz führen. 
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.           
  859.           
  860.                                                                    Seite 12
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.                                                   DOORSWAP.DOC Version 1.30
  869.                                                                  10.04.1991
  870.           
  871.           
  872.           3.1 Das Swapfile
  873.  
  874.           Ab Version 1.20 gibt es die Möglichkeit, den Namen des Swapfiles
  875.           zu variieren. Der Name des Swapfiles soll ein voll qualifizierter
  876.           Name sein; d.h. er soll aus Laufwerksbezeichnung, Pfad, Namen und
  877.           Extension bestehen. 
  878.  
  879.           Festgelegt wird der Name durch die Environmentvariable DSFILE.
  880.           Legen Sie den Namen in einer Batchdatei oder von DOS aus mit dem
  881.           Befehl
  882.  
  883.           SET DSFILE=xxx
  884.  
  885.           fest. Ist diese Variable nicht definiert, so wird C:\DOORSWAP.DAT
  886.           als Name angenommen.
  887.  
  888.           Der Name sollte voll qualifiziert sein. Beinhaltet er keine
  889.           Laufwerksbezeichnung, so wird das aktuelle Laufwerk benutzt.
  890.           Beeinhaltet er keinen Pfad, so wird der aktuelle Pfad benutzt.
  891.           Ändert das über DOOR aufgerufene Programm nach dem Auslagern des
  892.           Speichers eine dieser Einstellungen und ist der Name nicht voll
  893.           qualifiziert gewesen, so wird DOORSWAP sein Swapfile nicht mehr
  894.           finden. Der Absturz ist dadurch vorprogrammiert.
  895.  
  896.           Folgende Fehlerquellen finden sich im Filenamen:
  897.  
  898.           DOORSWAP.DAT
  899.  
  900.           Das File DOORSWAP.DAT im aktuellen Pfad des aktuellen Laufwerks
  901.           wird benutzt. Wenn nach Beendigung des Programmes ein anderer
  902.           Pfad bzw. ein anderes Laufwerk angewählt ist, führt dies zu einem
  903.           Absturz.
  904.  
  905.           \BBS\DOORSWAP.DAT
  906.  
  907.           Hier wird das angegebene File im aktuellen Laufwerk benutzt.
  908.           Sofern das aktuelle Laufwerk geändert wird, stürzt DOORSWAP beim
  909.           Nachladen ab.
  910.  
  911.           TEMP\DOORSWAP.DAT
  912.  
  913.           Hier wird das Verzeichnis TEMP benutzt, das vom aktuellen
  914.           Verzeichnis des aktuellen Laufwerks ausgeht. Wenn aktuelles
  915.           Laufwerk oder Verzeichnis geändert werden, so stürzt DOORSWAP
  916.           beim Rückladen ab.
  917.  
  918.           3.2 Ramdisk
  919.  
  920.           Sie können die gerade beschriebene Option dazu nutzen, DOORSWAP
  921.           auf eine RAM-Disk swappen zu lassen. Lediglich müssen Sie darauf
  922.           achten, daß diese RAM-Disk GARANTIERT noch 600 kBytes an
  923.           Speicherplatz frei hat. Das Swappen wird durch eine solche RAM-
  924.           Disk natürlich geradezu unverschämt schnell. Vergessen Sie bitte
  925.           auch nicht, daß diese RAM-Disk NICHT im DOS-Speicher liegen darf.
  926.  
  927.  
  928.  
  929.  
  930.           
  931.           
  932.                                                                    Seite 13
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.                                                   DOORSWAP.DOC Version 1.30
  941.                                                                  10.04.1991
  942.           
  943.           
  944.           3.3 Verschachteltes Swapping
  945.  
  946.           Die Möglichkeit, den Namen des Swapfiles zu bestimmen, können Sie
  947.           auch für andere Spielereien benutzen. 
  948.  
  949.           Angenommen, das aufgerufene Programm kann selbst weitere Software
  950.           nachladen, stellt aber (wie auch die Mailbox) nicht genügend
  951.           Speicherplatz hierfür zur Verfügung. Denkbar ist eine solche
  952.           Installation beispielsweise, wenn sie das Mailboxprogramm zur
  953.           Installation in mehreren Netzen mehrfach als eigene DOOR-Funktion
  954.           aufrufen.
  955.  
  956.           Sie können ab sofort aus der DOOR-Shell heraus DOORSWAP erneut
  957.           installieren. Sie MÜSSEN lediglich darauf achten, daß ein anderer
  958.           Swapfile-Name benutzt wird. In Kurzform eine
  959.           Beispielsinstallation: 
  960.  
  961.           Das Mailboxprogramm heißt BOX.EXE. Sie haben BOX.EXE in zwei
  962.           Installationen installiert, die in den Verzeichnissen INST_1 und
  963.           INST_2 liegen. 
  964.  
  965.           Die Batch-Datei, die das ERSTE Mailboxprogramm aufruft, sollte
  966.           folgende Zeilen beeinhalten:
  967.  
  968.           [...]
  969.           CD \INST_1
  970.           SET DSFILE=C:\BOX\DOORSWAP.001
  971.           BOX
  972.           [...]
  973.  
  974.           Die Batch-Datei des zweiten Programmes enthält dann folgende
  975.           Zeilen:
  976.  
  977.           [...]
  978.           DOORSWAP
  979.           CD \INST_2
  980.           SET DSFILE=C:\BOX\DOORSWAP.002
  981.           BOX
  982.           [...]
  983.  
  984.           Achten Sie insbesondere auf die Namen der Swapfiles und die
  985.           zweite Installation von DOORSWAP.COM.
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.           
  1003.           
  1004.                                                                    Seite 14
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.                                                   DOORSWAP.DOC Version 1.30
  1013.                                                                  10.04.1991
  1014.           
  1015.           
  1016.           4    Optionen
  1017.                --------
  1018.  
  1019.           Ab Version 1.30 gibt es ein paar Optionen, die man mit der
  1020.           Environment-Variablen DSOPT festlegen kann. Die einzelnen
  1021.           Optionen werden direkt hintereinander, durch Semikolons getrennt,
  1022.           angegeben. Ein Beispiel für eine Definition wäre dieses:
  1023.  
  1024.           SET DSOPT=DEL;FOSINIT
  1025.  
  1026.           Nun zu den Optionen im Einzelnen.
  1027.  
  1028.  
  1029.           DEL      - Löschen des Swapfiles.
  1030.  
  1031.           Wenn Sie diese Option angeben, so wird nach dem Zurückladen des
  1032.           Speichers das Swapfile gelöscht. Dies kann notwendig sein, wenn
  1033.           Sie auch zu anderen Zwecken den vom Swapfile belegten
  1034.           Speicherplatz benötigen (Export/Import von Nachrichten im
  1035.           Netzwerkbetrieb etwa). 
  1036.  
  1037.  
  1038.           COMx     - Angabe des COM-Ports für die Meldungen
  1039.  
  1040.           Falls Sie Ihre Mailbox mit mehreren Ports benutzen oder keine
  1041.           Standard-UART's installiert haben, kann es dazu kommen, daß die
  1042.           Meldungen auf dem falschen Port ausgegeben werden oder zu
  1043.           Abstürzen führen. Durch Angabe eines COM-Ports (durch Option COM1
  1044.           Port 1, durch COM2 Port 2 usw.) ermittelt DOOR.EXE das benutzte
  1045.           Port nicht selbständig. Wenn Sie COM0 angeben, wird die Ausgabe
  1046.           auf dem COM-Port unterdrückt. 
  1047.  
  1048.  
  1049.           FOSOUT   - Ausgabe der Meldungen über einen FOSSIL-Treiber
  1050.  
  1051.           Oft werden (wie schon erwähnt) FOSSIL-Treiber benutzt, um das
  1052.           COM-Port anzusprechen. Wenn auchin Ihrem Fall X00 oder BNU
  1053.           installiert ist, empfiehlt es sich, auch DOOR.EXE über diese
  1054.           Treiber die Ausgabe der Meldungen vornehmen zu lassen. 
  1055.  
  1056.  
  1057.           FOSINIT  - Initialisieren des FOSSIL-Treibers nach dem Rückladen
  1058.  
  1059.           Manche Spiele oder andere externe Programme nutzen ihrerseits den
  1060.           FOSSIL-Treiber nicht, was an sich nichts Schlimmes ist. Manche
  1061.           Programme verändern jedoch die Einstellungen des COM-Ports, ohne
  1062.           sie nach Beendigung wieder in die Ausgangszustände zu versetzen.
  1063.           Wenn der FOSSIL-Treiber, den die Mailbox benutzt, dies nicht
  1064.           'weiß', so wird er möglicherweise mit einem komplett anderen
  1065.           Verhalten des Port-Bausteines konfrontiert, als er es erwartet.
  1066.           Im günstigsten Fall nimmt die Mailbox keine Eingabe mehr an und
  1067.           bootet, nachdem der User aufgelegt hat, von selbst neu. 
  1068.  
  1069.           Durch Setzen von FOSINIT wird noch VOR der Ausgabe von DOOR's
  1070.           Meldung der FOSSIL-Treiber auf das benutze COM-Port
  1071.           initialisiert, was bedeutet, er wird aufgefordert, das COM-Port
  1072.           so einzustellen, wie er es erwartet. In manchen Fällen kann dies
  1073.           die Abstürze vermeiden. 
  1074.           
  1075.           
  1076.                                                                    Seite 15
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.                                                   DOORSWAP.DOC Version 1.30
  1085.                                                                  10.04.1991
  1086.           
  1087.           
  1088.           Und hier noch ein Beispiel für die Anwendung mehrerer Optionen:
  1089.  
  1090.           Sie wollen, daß DOOR.EXE die Meldungen über seine Aktivität
  1091.           ausgibt, die Mailbox läuft auf Port 2 in einem Multitasking-
  1092.           system. Damit nicht, während Sie selbst unter einer zweiten Task
  1093.           über COM1 in einer anderen Mailbox arbeiten, das falsche COM-Port
  1094.           zur Ausgabe benutzt wird, wollen Sie das COM-Port selbst
  1095.           definieren. 
  1096.  
  1097.           Wenn Sie morgens von Ihrem FIDO-Host pollen, wird es wegen
  1098.           einiger durchlaufender Echos auf der Platte vorübergehend etwas
  1099.           eng. Also soll das Swapfile automatisch gelöscht werden.
  1100.           Zusätzlich wollen Sie den FOSSIL-Treiber (etwa X00)
  1101.           initialisieren, weil das benutzte Spiel ab und zu einen Absturz
  1102.           des Treibers hervorruft. Bei dieser Gelegenheit soll auch
  1103.           gleichzeitig der FOSSIL-Treiber zur Ausgabe benutzt werden, um
  1104.           alle Absturzmöglichkeiten auszuschließen.
  1105.  
  1106.           Hierzu müssen Sie vor Aufruf von DOOR.EXE (etwa in der
  1107.           AUTOEXEC.BAT) folgende Befehlszeile ausführen lassen:
  1108.  
  1109.           SET DSOPT=COM2;DEL;FOSINIT;FOSOUT
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.           
  1147.           
  1148.                                                                    Seite 16
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.                                                   DOORSWAP.DOC Version 1.30
  1157.                                                                  10.04.1991
  1158.           
  1159.           
  1160.           5    Zukunftsvisonen
  1161.                ---------------
  1162.  
  1163.           Ja, auch DOORSWAP soll verbessert werden.
  1164.  
  1165.           Wenn sich im Betrieb in andern als den bisher getesteten Systemen
  1166.           Probleme zeigen sollten, so wird DOORSWAP selbstverständlich an
  1167.           diese angepaßt werden. Allerdings müssen Sie, bei denen die
  1168.           Probleme auftreten, sich mit mir in Verbindung setzen. Natürlich
  1169.           auch dann, wenn Sie das Programm gerade testen und noch nicht
  1170.           registriert haben.
  1171.  
  1172.           Vorab sei aber erwähnt, was für Änderungen in den Folgeversionen
  1173.           bereits konzipiert sind.
  1174.  
  1175.           Es ist geplant, daß der von DOORSWAP benötigte Interrupt vom
  1176.           Anwender gewählt werden kann. Möglicherweise wird das eine oder
  1177.           andere Mailboxprogramm selbst über Interrupts Funktionen
  1178.           aktivieren.
  1179.  
  1180.           Irgendwann werde ich mir auch Gedanken machen, wie ich eine
  1181.           Mehrfachinstallation von DOORSWAP.COM verhindern kann.
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.           
  1219.           
  1220.                                                                    Seite 17
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.                                                   DOORSWAP.DOC Version 1.30
  1229.                                                                  10.04.1991
  1230.           
  1231.           
  1232.           6    Fehlermeldungen
  1233.                ---------------
  1234.  
  1235.           Es gibt einige selbsterklärende Fehlermeldungen vom Runtime-
  1236.           System des Modula-2-Compilers von Fittet Software Tools. DOOR.EXE
  1237.           ist komplett in M2 geschrieben.
  1238.  
  1239.           Ein paar Fehlermeldungen, die sich auf den Aufruf von DOOR.EXE
  1240.           beziehen, sind auch implementiert:
  1241.  
  1242.  
  1243.           'No Parameters passed by calling process'
  1244.  
  1245.           DOOR.EXE wurde ohne Parameter aufgerufen. Daher weiß es nicht,
  1246.           welches Programm gestartet werden soll und bricht ab.
  1247.  
  1248.  
  1249.           'DOORSWAP.COM not installed or wrong version'
  1250.  
  1251.           Sie müssen das DOORSWAP.COM installieren, das im Vertriebspaket
  1252.           der benutzten Version von DOOR.EXE enthalten war. DOOR.EXE kann
  1253.           nur mit dieser Version von DOORSWAP.COM arbeiten.
  1254.  
  1255.  
  1256.           'Unknown option found in DSOPT'
  1257.  
  1258.           In DSOPT wurde eine falsche Option angegeben. Da DOOR.EXE jetzt
  1259.           nicht mehr sicher sein kann, daß Sie wissen, was Sie wollen,
  1260.           bricht das Programm ab.
  1261.  
  1262.  
  1263.           'Evaluation copy does not work today'
  1264.  
  1265.           Sie benutzen die Test-Version von DOORSWAP. Diese funktioniert an
  1266.           allen Tagen, deren Tageszahl durch 5 teilbar ist, nicht. Dieser
  1267.           Zustand kann erst behoben werden, wenn Sie DOORSWAP registrieren.
  1268.  
  1269.  
  1270.           Dann kann auch DOORSWAP.COM während der Interruptaktivitäten
  1271.           Meldungen über Fehler ausgeben. Auch diese erklären sich selbst,
  1272.           besagen aber nur, daß irgendein DOS-Austricksen nicht richtig
  1273.           funktioniert hat. Es muß nicht, kann aber zu Abstürzen führen.
  1274.           Viel können weder Sie noch ich daran ändern, da es vermutlich an
  1275.           Ihrer DOS-Version liegt. Allerdings freue ich mich über jeden
  1276.           Hinweis auf Fehler und stehe natürlich Rede und Antwort. 
  1277.  
  1278.           Die nächsten erwähnenswerten Fehlermeldungen sind die, die beim
  1279.           Laden von COMMAND.COM auftreten können.
  1280.  
  1281.           Hier hatte sich in den Vorversionen meine eigene Faulheit
  1282.           durchgesetzt: Die DOS-Funktion zum Starten von Tochterprozessen
  1283.           gibt die Fehler numerisch kodiert zurück. Ich hatte allerdings
  1284.           keine Lust, auch noch eine Ausgaberoutine für Zahlenwerte in
  1285.           Assembler zu schreiben, also addierte ich der Einfachheit halber
  1286.           20h (chr$(32)) zu dem Fehlercode und wies DOORSWAP an, das
  1287.           Ergebnis als ASCII auszugeben.
  1288.  
  1289.           Seit Version 1.20 wird aber von DOOR.EXE nach Rückkehr vom
  1290.           
  1291.           
  1292.                                                                    Seite 18
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.                                                   DOORSWAP.DOC Version 1.30
  1301.                                                                  10.04.1991
  1302.           
  1303.           
  1304.           mißglückten Aufruf der Fehlercode entschlüsselt und ausgegeben.
  1305.           Alle diese Fehlermeldungen beziehen sich auf das in COMSPEC
  1306.           angegebene File (meistens COMMAND.COM).
  1307.  
  1308.           5.1 'returned from DOORSWAP without Error.'
  1309.  
  1310.           Herzlichen Glückwunsch: Kein Fehler ist aufgetreten.
  1311.  
  1312.           5.2 'FATAL ERROR: Illegal call of DOS-Function.'
  1313.  
  1314.           Hier scheint ein Irrtum vorzuliegen: Die zum Start des
  1315.           Tochterprozesses aufgerufene DOS-Funktion kommt mit der
  1316.           Wertübergabe nicht zurecht. Überprüfen Sie, ob irgendwelche
  1317.           Änderungen im File DOORSWAP.COM vorgenommen wurden und ob Sie
  1318.           eine DOS-Version ab 3.00 benutzen. Sofern DOORSWAP.COM
  1319.           unverändert ist und Ihre DOS-Version 3.0 oder später ist: Setzen
  1320.           Sie sich bitte mit mir in Verbindung.
  1321.  
  1322.           5.3 "COMSPEC 'C:\COMMAND.COM' not found!"
  1323.  
  1324.           Überprüfen Sie die Einstellung der Variablen COMSPEC. Sie stimmt
  1325.           nicht.
  1326.  
  1327.           5.4 "Out of memory error: can't load 'C:\COMMAND.COM'!"
  1328.  
  1329.           Nun, dies sollte gerade nicht passieren. Offenbar ist die
  1330.           Speicherfreigabe fehlgeschlagen. Das liegt vermutlich an Ihrer
  1331.           DOS-Version. Bitte informieren Sie mich!
  1332.  
  1333.           5.3 "COMSPEC 'C:\COMMAND.COM' not found!"
  1334.  
  1335.           Ihr Kommandointerpreter ist ein EXE-File, das leider einen
  1336.           defekten Dateiaufbau hat. Ersetzen Sie es durch eine Kopie von
  1337.           Ihrer DOS-Sicherheitskopie (so sie denn noch eine haben)
  1338.  
  1339.           5.6 'Unknown Error.'
  1340.  
  1341.           Die DOS-Funktion gibt einen Fehlercode zurück, den DOS bis
  1342.           Version 4.01 noch nicht kannte.
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.           
  1363.           
  1364.                                                                    Seite 19
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.                                                   DOORSWAP.DOC Version 1.30
  1373.                                                                  10.04.1991
  1374.           
  1375.           
  1376.           7    Index
  1377.  
  1378.  
  1379.              Adresse                   5
  1380.              Aktivatorprogramm        11    FATAL ERROR: Illegal call
  1381.              Änderungen                5       of DOS-Function.      19
  1382.              Anpassungen               5    Fehlermeldungen          18
  1383.              ANSI.SYS                  9    Festplatte                8
  1384.              AUTOEXEC.BAT             11    FIDO                     16
  1385.                                             Fittet Software Tools    18
  1386.              BASIC                     3    FOREM PC                 12
  1387.              BATCH-Datei              11    FOSINIT               15,16
  1388.              BNU.SYS             9,15,16    FOSOUT                   15
  1389.              BOX in der BOX           14    FOSOUT                   16
  1390.                                             FOSSIL              9,15,16
  1391.              C                         3    FOSSIL, Initialisieren   15
  1392.              Cache-Speicher            9
  1393.              Carrier Detect            8    Gerätetreiber             9
  1394.              COM                   15,16    Geschichtliches          22
  1395.              COM-Port              15,16    Gewährleistung            7
  1396.              COM-Port, blockiertes    15    GLACTIC WARZONE           8
  1397.              COM-Ports, mehrere       15
  1398.              COMMAND.COM           11,18    Installation             11
  1399.              Commodore PC 10           8    Interrupt 62h             8
  1400.              COMSPEC                  11    Interrupt, Wählen des    17
  1401.              COMSPEC 'C:\COMMAND.COM'       Interrupts                9
  1402.                 not found!            19    Interruptvektoren        11
  1403.  
  1404.              Dateiname                13    Kommandozeile            12
  1405.              Datenschutz               6    Komprimierung             3
  1406.              DEL                   15,16    Kopieren                  4
  1407.              DeskView                  8    Kopierlizenz              4
  1408.              DOOR.EXE            8,16,18
  1409.              DOORSWAP.COM          11,18    Laufwerke                12
  1410.              DOORSWAP.COM not               Level                    12
  1411.                 installed or wrong          Lizenzabkommen            5
  1412.                 version               18    Lizenzgebühr              5
  1413.              DOORSWAP.DAT             13
  1414.              Doppelinstallaion        14    Mehrfachinstallation  11,17
  1415.              DOS 3.0                   9    Meldungen                15
  1416.              DOS 3.20                  9    Meldungen, Unterdrücken
  1417.              DOS 4.01                  9       der                   15
  1418.              DOS-Version              18    Modula 2                 18
  1419.              DSFILE                11,13    Multitasking             16
  1420.              DSOPT              11,15,18
  1421.              DSZ                       3    Nachladen v. Programmen  12
  1422.                                             Netzwerkbetrieb          15
  1423.              Environment        13,15,18    No Parameters passed by
  1424.              Evaluation copy does not          calling process       18
  1425.                 work today            18
  1426.              EXTERN                    3    Online-Spiele             3
  1427.                                             Optionen              15,18
  1428.                                             Out of memory error:
  1429.                                                 can't load
  1430.                                                 'C:\COMMAND.COM'!    19
  1431.  
  1432.  
  1433.  
  1434.           
  1435.           
  1436.                                                                    Seite 20
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.                                                   DOORSWAP.DOC Version 1.30
  1445.                                                                  10.04.1991
  1446.           
  1447.           
  1448.  
  1449.  
  1450.  
  1451.              Plattenspeicher       15,16
  1452.              Preis                     5
  1453.              Public Domain             4
  1454.  
  1455.              RAM-Disk               9,13
  1456.              Registriernummer          5
  1457.              Registrierung          5,18
  1458.              residenter Teil          11
  1459.              returned from DOORSWAP
  1460.                 without Error.        19
  1461.  
  1462.              Sammellizenz              5
  1463.              SearchlightBBS           12
  1464.              Semikolon                15
  1465.              Shareware              4,18
  1466.              Shareware-Sammlung        4
  1467.              SHELL                  3,11
  1468.              SIDEKICK                  9
  1469.              Speicherplatz             8
  1470.              Standard-UART            15
  1471.              Statistiksoftware         3
  1472.              Swapfile           11,13,15
  1473.              Swapfile, Löschen des    16
  1474.              SYSTEM                    3
  1475.              Systemvoraussetzungen     8
  1476.  
  1477.              Tastaturtreiber           9
  1478.              TBOX                     12
  1479.              Testversion              18
  1480.              Ticker-Interrupt          9
  1481.              Tochterprozesse           3
  1482.  
  1483.              UART 8250                 8
  1484.              Übertragungsprotokolle    3
  1485.              Unknown option found in
  1486.                 DSOPT                 18
  1487.              Update                    5
  1488.  
  1489.              Verschachteltes Swapping 14
  1490.              X00.SYS             9,15,16
  1491.              Zahlung                   5
  1492.              Zukunftsvisionen         17
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.           
  1507.           
  1508.                                                                    Seite 21
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.                                                   DOORSWAP.DOC Version 1.30
  1517.                                                                  10.04.1991
  1518.           
  1519.           
  1520.           8    Geschichtliches
  1521.                ---------------
  1522.  
  1523.           Hier mal ein paar kleinere Sätzchen über die Entwicklung von
  1524.           DOORSWAP.
  1525.  
  1526.  
  1527.  
  1528.            8. 3. 1990      Freigabe von DOORSWAP 1.0. Zugleich Datum von
  1529.                            DOORS10.COM
  1530.  
  1531.           11. 3. 1990      Beginn der Arbeiten an V1.1
  1532.                            Hierbei wurden insbesondere Unzulänglichkeiten
  1533.                            u.a. in TurboPascal 3.00 verändert. Turbo Pascal
  1534.                            in V3.00 beutzt standardmäßig den INT 10H zur
  1535.                            Ausgabe von Zeichen. Zu Beginn wird dann
  1536.                            versucht, die Grafikkarte in einen bestimmten
  1537.                            Zustand zu versetzen. Das gab bei manchen BIOS-
  1538.                            Versionen Probleme. Als Hauptänderung wurde in
  1539.                            V1.1 die Ausgabe auf STDOUT gelenkt. V1.1 wurde
  1540.                            nicht veröffentlicht, aber seit Mai 1990 als
  1541.                            registrierte Version benutzt.
  1542.  
  1543.           22.11. 1990      Veröffentlichung von V1.20. Folgende Änderungen
  1544.                            wurden vorgenommen:
  1545.                            - DOOR.EXE, vorher DOOR.COM, ist nunmehr in
  1546.                              Modula-2 codiert. Da ich sämtliche Libraries
  1547.                              des Compilers im Source besitze, weiß ich
  1548.                              definitiv, daß es jetzt keine BIOS-Probleme
  1549.                              mehr geben kann. 
  1550.                            - DOOR.EXE erkennt, ob DOORSWAP.COM in der
  1551.                              entsprechenden Version überhaupt installiert
  1552.                              ist. 
  1553.                            - DOOR.EXE wertet die Environment-Variable
  1554.                              DSFILE aus und setzt deren Wert als Namen des
  1555.                              Swap-Files ein.
  1556.  
  1557.           28.02.1991       Veröffentlichung von V1.21. Einige kleinere
  1558.                            optischen Verschönerungen und ein Bugfix wurden
  1559.                            vorgenommen. Bei V1.2 gab es gelegentlich
  1560.                            Probleme, weil ab und an das COM-Port nicht
  1561.                            richtig erkannt wurde. Es wurde daher bei
  1562.                            einzelnen Systemen die Copyright-Meldung über
  1563.                            *irgendein* COM-Port auszugeben (statt COM1).
  1564.                            Bei andern Systemen wurde die Adresse aus der
  1565.                            DOS-COM-Port-Liste vom nächsthöheren Port
  1566.                            genommen, auch, wenn diese auf 0H zeigte (weil
  1567.                            das Port nicht existierte). Da der DMA-
  1568.                            Controller dort sitzt und tatsächlich fast so
  1569.                            aussieht, wie ein COM-Port mit gesetztem
  1570.                            Carrier, wurde die Meldung über den DMA-
  1571.                            Controller ausgegeben. Beide Fehler führten zu
  1572.                            merkwürdigen Abstürzen (die ich hier nicht
  1573.                            nachvollziehen konnte - sorry, sonst hätte ich
  1574.                            den Bug schon vorher entdeckt).
  1575.  
  1576.  
  1577.  
  1578.           
  1579.           
  1580.                                                                    Seite 22
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.                                                   DOORSWAP.DOC Version 1.30
  1589.                                                                  10.04.1991
  1590.           
  1591.           
  1592.           05.04.1991       Die Test an Version 1.30 sind abgeschlossen und
  1593.                            langsam rückt der Termin der Freigabe näher.
  1594.                            Folgende Änderungen wurden vorgenommen:
  1595.                            - Die Shareware-Version arbeitet an allen Tagen,
  1596.                            deren Tageszahl durch 5 teilbar ist, nicht.
  1597.                            - Dafür kann man die Meldungen unterdrücken oder
  1598.                            ein COM-Port zur Ausgabe vorschreiben.
  1599.                            - Der FOSSIL-Treiber kann zur Ausgabe benutzt
  1600.                            werden.
  1601.                            - Er kann auch vor Rückkehr zur Mailbox
  1602.                            initialisiert werden. 
  1603.                            - DOOR.EXE kann auf Verlangen das Swapfile
  1604.                            selbständig löschen.
  1605.                            - Die Meldungen wurden etwas verkürzt und
  1606.                            verschönert. U.a. gibt DOOR.EXE über das COM-
  1607.                            Port zunächst ein paar RETURN's aus, weil manche
  1608.                            Mailboxprogramme den Curser nach der
  1609.                            Befehlseingabe hinter dem Befehl stehen lassen.
  1610.                            - Die Dokumentation enthält ein alphabetisches
  1611.                            Stichwortverzeichnis
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.           
  1651.           
  1652.                                                                    Seite 23
  1653.  
  1654.  
  1655.  
  1656.  
  1657.